docs/development/Building in Eclipse.md

   1 # Short Version
   2 Install the latest Eclipse Standard/SDK and install the **C/C++ developments Tools** plugins
   3 ![plugin eclipse](http://i.imgur.com/IdJ8ki1.png)
   4
   5 Import the project using the wizard **Existing Code as Makefile Project**
   6 ![](http://i.imgur.com/XsVCwe2.png)
   7
   8 Adjust your build option if necessary
   9 ![](https://camo.githubusercontent.com/64a1d32400d6be64dd4b5d237df1e7f1b817f61b/687474703a2f2f692e696d6775722e636f6d2f6641306d30784d2e706e67)
  10
  11 Make sure you have a valid ARM toolchain and Ruby in the path
  12 ![](http://i.imgur.com/dAbscJo.png)
  13
  14 # Long version
  15 * First you need an ARM toolchain. Good choices are **GCC ARM Embedded** (https://launchpad.net/gcc-arm-embedded) or **Yagarto** (http://www.yagarto.de).
  16 * Install Ruby (see the document for your operating system).
  17 * Now download Eclipse and unpack it somewhere. At the time of writing Eclipse 4.2 was the latest stable version.
  18 * To work with ARM projects in Eclipse you need a few plugins:
  19         + **Eclipse C Development Tools** (CDT) (available via *Help > Install new Software*).
  20         + **Zylin Embedded CDT Plugin** (http://opensource.zylin.com/embeddedcdt.html).
  21         + **GNU ARM Eclipse** (http://sourceforge.net/projects/gnuarmeclipse/).
  22         + If you want to hook up an SWD debugger you also need the **GDB Hardware Debugging** plugin (Also available via *Install new Software*).
  23 * Now clone the project to your harddrive.
  24 * Create a new C project in Eclipse and choose ARM Cross Target Application and your ARM toolchain.
  25 * Import the Git project into the C project in Eclipse via *File > Import > General > File System*.
  26 * Activate Git via *Project > Team > Share Project*.
  27 * Switch to the development branch in Eclipse (*Project > Team > Switch To > development*).
  28 * The next thing you need to do is adjust the project configuration. There is a Makefile included that works but you might want to use GNU ARM Eclipse's automatic Makefile generation. Open the Project configuration and go to *C/C++ Build > Settings*
  29         * Under *Target Processor* choose "cortex-m3"
  30         * Under *ARM Yagarto [Windows/Mac OS] Linker > General* (or whatever toolchain you chose)
  31                 + Browse to the Script file *stm32_flash.ld*
  32                 + Uncheck "Do not use standard start files"
  33                 + Check "Remove unused sections"
  34         * Under *ARM Yagarto [Windows/Mac OS] Linker > Libraries*
  35                 + Add "m" for the math library
  36         * Under *ARM Yagarto [Windows/Mac OS] Compiler > Preprocessor* add the following 2 items to "Defined Symbols":
  37                 + STM32F10X_MD
  38                 + USE_STDPERIPH_DRIVER
  39         * Under *ARM Yagarto [Windows/Mac OS] Compiler > Directories* add the following 3 items
  40                 + ${workspace_loc:/${ProjName}/lib/CMSIS/CM3/CoreSupport}
  41                 + ${workspace_loc:/${ProjName}/lib/CMSIS/CM3/DeviceSupport/ST/STM32F10x}
  42                 + ${workspace_loc:/${ProjName}/lib/STM32F10x_StdPeriph_Driver/inc}
  43         * Under *ARM Yagarto [Windows/Mac OS] Compiler > Miscellaneous* add the following item to "Other flags":
  44                 + -fomit-frame-pointer
  45 * The code in the support directory is for uploading firmware to the board and is meant for your host machine. Hence, it must not be included in the build process. Just right-click on it to open its properties and choose "Exclude from build" under *C/C++ Build > Settings*
  46 * The last thing you need to do is adding your toolchain to the PATH environment variable.
  47         + Go to *Project > Properties > C/C++ Build > Environment*, add a variable named "PATH" and fill in the full path of your toolchain's binaries.
  48         + Make sure "Append variables to native environment" is selected.
  49 * Try to build the project via *Project > Build Project*.
  50 * **Note**: If you're getting "...could not be resolved" errors for data types like int32_t etc. try to disable and re-enable the Indexer under *Project > Properties > C/C++ General > Indexer*.